Copyright: 1999-2001,  M. Onyshchuk


1.Features
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version
PhotoCDBrowser displays photos and images - graphic files on compact discs or in folders on a hard disk drive. The basic program features are described below:

•	Supported graphic formats: *.tif *.jpg *.bmp *.pcx *.tga *.eps

•	Image zooming

•	zoom out with a 10% step

•	zoom in with a 10% step

•	1:1 scale mode

•	"fit to screen" scale

•	IntelliMouse zooming support

•	reposition a zoomed image area vertically, horizontally or diagonally using a mouse or keyboard

•	save image scale to apply to next photos

•	Thumbnails mode

•	Image rotation (through 90° or 5°)

•	Navigation on files:

•	through navigator window

•	by "hot keys"

•	by IntelliMouse

•	Slideshow modes:

•	small slideshow - automatically displays photos in the current navigator folder

•	total slideshow - automatically displays photos in the current folder and all subfolders or displays all images on a CD or hard drive

•	slideshow by script

•	Option to run a slideshow at the startup of the program

•	Comments to photos are supported:

•	embedded in graphic files (JPEG, TIFF)

•	contained in text files

•	sound comments

•	date and time stamps from digital camera

•	Comments to folders and slideshows scripts are supported, global comment is available too

•	Macros and Tags in comment text are supported

•	Program setup is realized by means settings files:

•	there is a global settings file. (it can be passed to program by command line)

•	it is supported attached settings files to photo-files, folders, slideshow scripts.

•	Skins ("themes") are supported

•	The language of the program menus and dialogs can be determined by the contents of textual files (*.lang.txt), which can be edited or added

•	Program works under:

•	Windows 95

•	Windows 98

•	Windows NT 4.0

•	Windows 2000

•	Windows ME

•	Windows XP

* * *


2.AllCommands
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version

2.1 Main commands

2.2 Menu commands

2.3 Slideshow commands

2.4 Advanced commands

2.5 Mouse support

2.6 Command line

2.7 Other

The program consists of a main window for viewing photos and a navigator window for selecting image files. The majority of the commands can be accessed both from the menu and with the keyboard.

2.1 Main  commands

F1	- press this for help

F2	- press this for hot key hints

F10	- shows the menu (or click the right mouse button)

2	- run second instance of programm

Ctrl + L	- change the language of the program’s interface

Alt+X	- exit.

2.2 Menu  commands

PageUp	- zoom in current image.

PageDown	- zoom out current image.

Home	- set real scale - 1:1

End	- set "fit to screen scale" - scale, at which the image is adjusted under the sizes of the screen.

Arrows up, down, to left, to right	- moving of the zoomed image.fragment

"("	- to rotate current photo to the left by 90°.

")"	- to rotate current photo to the right by 90°.

   	  Pressing the Ctrl key allows rotating photo slowly - by 5°.

"-"	- go to previuos photo.

"+"	- go to next photo.

Esc	- show or hide navigator window. Also zooming in or out on an image causes the navigator window to hide.

SpaceBar	- show or hide comments to photos. Also comments hide when moving or zooming the active photo.

F4	- turn on or turn off sound comment.

F3	- turn on or turn off background music. Whether background music is playing is determined by the parameters in the [Music Settings] section of setting file.

These commands are accessible only if the main window of the program is active not when navigator window is active. To switch between these windows use the Tab key.

2.3 Slideshow commands

To view the complete list of commands and details about how they work see section 3. Slideshow

2.4 Advanced commands

Ctrl + F	- show font dialog box

Ctrl + B	- apply or cancel bold style

Ctrl + I	- apply or cancel italic style

Ctrl + U	- apply or cancel underline style

Ctrl + "}"	- increase font size by 2 units (max size is 48)

Ctrl + "{"	- decrease font size by 2 units (min size is 8)

Please note that the font commands above are accessible only when the comment is visible. In using these commands remember that True Type fonts will react smoothly and uniformly to changes in font size while raster fonts will be less predictable.

Ctrl + T	- run Notepad to edit comment text file

Ctrl + Del	- delete comment text file

Shift + T	- run Notepad to edit text file with comment to folder

Shift + Del	- delete text file with comment to folder

Ctrl + C	- open dialog to setup a comment color.

Shift + C	- open dialog to setup a comment shadow color.

Ctrl + R	- begin or finish setup of comment rectangle

Ctrl + Ins	- copy comment text to the clipboard

F5	- refresh the image or list of files depending on which window is active - main or navigator window.

Ctrl + E	- run Explorer in the current folder.

Ctrl + O	- open the current file with the external program. The external program is the program associated with the current file in Windows Explorer. It is possible to set the external program to another program in the settings file (OpenWith parameter)

Alt + S	- saving/not saving the image scale to be applied to the next photo after a transition. The scale setting is kept in the settings file.(ScaleSavingMode parameter)

Alt + C	- open dialog box to set the background color of the main window.

Ctrl + F1	- copy all macros and tags to the clipboard

Ctrl + D	- run Notepad to edit settings file attached to the current photo

Ctrl + Backspace - delete settings file attached to the current photo

Shift + D	- run Notepad to edit settings file in the current folder

Shift + Backspace - delete settings file in the current folder

2.5 Mouse support

If the image falls outside the limits the screen, it can be moved with the mouse. Position the pointer, press the left mouse button and without releasing it, move the mouse cursor in the direction you wish to move the image then release the mouse button.

As you zoom in on an image, the outer area of the image will at some point exceed the limits of the screen.  When this occurs the mouse cursor changes from the ordinary pointer to this:and by pressing the left mouse button the cursor will show all the possible directions for moving the image such as this:.

If your mouse supports them, PhotoCDBrowser is compatible with the scaling and scrolling modes of MS Office 97-2000.

If your mouse is an IntelliMouse or compatible, the program gives you additional capabilities. You can use the mouse wheel to either zoom in or out on the current mage or change to the next image within the current folder. To switch between these modes use the following command:

Alt + Z	- switches the IntelliMouse wheel button function between zooming and navigation. The setting is kept in the settings file.(IntelliMouseMode parametr)

Double clicking the left mouse button sets the scale of the current image to "fit to screen".

2.6 Command Line

Program can processed command line. You can pass in command line various files:

•	files to view, thus you can register PhotoCDBrowser as the default viewer for those file formats

•	pathes to folder to open in Navigator window

•	name of a slideshow script. A slideshow script specified in a command line has higher priority than the script specified in the setup file parameter SlideShowAutoExecScript

•	settings file which will replace global settings file

2.7 Other

If you do not want the PhotoCDBrowser.wav file to play during start,

press the Ctrl key. This is true for the sound comments too.

* * *


3.Slideshow
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version

3.1 Small slideshow

3.2 Total slideshow

3.3 Slideshow scripts

3.4 Common slideshow commands

The following are the slideshow modes of PhotoCDBrowser.

3.1 Small slideshow

The small slideshow displays all files in the current folder only. The current folder is the folder displayed in the navigator window.

During a small slideshow the mouse cursor looks like this:

The small slideshow can be activated from the menu by choosing "Slideshow Small", or by pressing the F12 key. To leave the small slideshow mode just press any key or the right mouse button.

3.2 Total slideshow

The total slideshow differs from the small slide show in that it displays all image files in the current folder and all subdirectories of the current folder.

During the search for these files the mouse cursor looks like:  after the search it looks like :  and in pause mode it looks like:

To start a total slideshow click the left mouse button and choose Slideshow Total from the menu or use the following keys from the keyboard:

F8	-.begin or continue total slideshow.

F9	-.stop total slideshow. After using the stop slideshow command the folder that was active before the slideshow began becomes the current folder.

Pause	-.stop or continue total slideshow.

"-"	- go to previous photo in total slideshow. After using the previous photo command the slideshow stops..

"+"	- go to next photo in total slideshow. After using the next photo command the slideshow stops.

3.3 Slideshow scripts

If a slideshow script is placed in the same folder where the PhotoCDBrowser program is located Total Slideshow will display an intermediate menu that will allow you to choose between a slideshow composed of the files listed in the script or composed of the files in the current folder (as listed in the navigator window). A simple method for creating a script is to run the following command during a Total Slideshow::

Ctrl + S 	 - to create the script for the current total slideshow.

 This command will create a slideshow script file in the same directory where the PhotoCDBrowser program is located. After the slideshow has completed, this file can be renamed and edited. This command is useful in the planning stages of designing a CD for your photos. It is no longer useful once the CD has been created. The parameter SlideShowAbsolutePathes from settings file determines what type of file path (absolute or relative) will be written to the script.

3.4 Common slideshow commands

"*"	- accelerates a slideshow. The transition period between the display of photos is increased by 50 %. After executing this command there is a transition to the next photo.

"/"	- slows down a slideshow. The period between the display of photos decreases by one third.

After the acceleration or delay of a slideshow the duration of the last transition is written to the SlideShowDelay parameter in the settings file.

* * *


4.CDCreation
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version

4.1 Photo preparation

4.2 Macros

4.3 Tags

4.4 PhotoCDBrowser setup

4.5 Autorun

To create a CD of your favorite photos, it is of course necessary to have a CD-Writer. Then make a list of all the photos you wish to have on your CD and acquaint yourself with how to setup PhotoCDBrowser correctly.

Next determined the structure of the folders on your CD. Let's assume that in the root directory of your CD you will create 2 directories (folders); one named Archive and one named Browser. In the first directory you will arranged all your photos and in second you will place the PhotoCDBrowser program files. Now it is necessary to prepare the photos and setup the PhotoCDBrowser program.

4.1 Photo preparation

Only place image file types in your Archive folder that can be recognized by the PhotoCDBrowser program. The formats it recognizes are: *.tif *.jpg *.bmp *.pcx *.tga *.eps.

If desired you can add comments to your photos:

•	sound

•	textual

For saving comments to your photos in TIFF or JPEG format, it is necessary to create a graphics file in Adobe Photoshop. From the menu choose File then File Info... and you will then see the dialog represented below

In the Caption field you can type the text of the comment to an image file.

4.2 Macros

Macros is a keywords between percent characters wich will be replaced by special text before comment showing. Macros is processed in comment text only. List of macros with explanations:

%FILE_NAME% 	- this macros will be replaced by current file name with extantion.

%SHORT_FILE_NAME%	- current file name without extantion.

%FOLDER_NAME%	- name of the current folder (same as a first item in the navigator window).

%PATH%	- full path to the current folder.

%IMAGE_WIDTH%	- width of the current photo in pixels.

%IMAGE_HEIGHT%	- height of the current photo in pixels.

%IMAGE_SIZE_K%	- size of the current file in kilobytes.

%IMAGE_SIZE_M%	- size of the current file in megabytes.

4.3 Tags

It is possible to use special tags in the text of comment. Examples of all tags are shown below:

<REM> The text within these tags are remarks and will not be displayed </REM>

<SOUND> Text within this tag will be seen only if the sound comment feature is turned on </SOUND>

<MUSIC> This text will be seen only if background music is turned on </MUSIC>

<SLIDESHOW> This text will be seen only during a slideshow </SLIDESHOW>

It is also possible to use language tags which match the name of the current interface language file. For example if the parameter ApplicationLanguage=English, i.e. current language file is English.lang.txt, then:

<ENGLISH> The comment text within these tags will be seen </ENGLISH>. However if you choose another language, the comment text within the above English tags becomes invisible.

All opening tags should have closing tags. Symbols within a tag have no special meaning. Tags can be nested. Unrecognized tags which satisfy the rules described above are treated as REM tags. Negative tags can also be used. Examples of negative tags are shown below:

<!SOUND> This text will be seen only if the sound comment is turned off </!SOUND>

<!SLIDESHOW> This text will be seen only if there is no slideshow in progress </!SLIDESHOW>

4.4 PhotoCDBrowser setup

For PhotoCDBrowser to successfully display the photos on your CD you must configure it correctly . Configuration consists of creating a autorun.inf file for the CD and creating and editing the PhotoCDBrowsr.ini file.

This is in addition to creating any scripts for slideshows needed for your CD.

4.5 Autorun

If you wish to have PhotoCDBrowser auto start (where it starts automatically when the CD is inserted into the CDROM drive) then you will need to edit or create an autorun.inf file. This file should be placed in the root directory of your CD. Here is how it should look using our example above:

[AutoRun]

Open=Browser\PhotoCDBrowser.exe

Icon=Browser\PhotoCDBrowser.exe,0

The number 0 at the end of the second line above means that the first icon of the program is displayed by the autorun feature in Windows Explorer or My Computer. To change icons substitute any of the other numbers assigned to the icons in the program as shown below. There are a total of 5 icons to choose from:

The file autorun.inf can contain additional parameters which, for example, will allow the MS Windows Explorer or My Computer to display two slideshow scripts. Here is how to expand the autorun selection feature:

[AutoRun]

Open=Browser\PhotoCDBrowser.exe

Icon=Browser\PhotoCDBrowser.exe,0

Shell\Script1=&Slideshow Script 1 ...

Shell\Script1\command=Browser\PhotoCDBrowser.exe script1.script.txt

Shell\Script2=&Slideshow Script 2 ...

Shell\Script2\command=Browser\PhotoCDBrowser.exe script1.script.txt

In the case above there are 2 slideshow scripts: script1.script.txt and script2.script.txt. The popup menu displayed when the user clicks the right mouse button on the CD-drive where your CD is inserted looks like this:

* * *


5.InterfaceSetup
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version

5.1 Default files

5.2 PhotoCDBrowser.ini setup

5.3 Setting files redefinition

5.4 Multilanguage support

The interface of the program depends on:

•	the predetermined files (files by default - PhotoCDBrowser.*)

•	the values of the parameters in the setup file

•	files which carrying out the translation of the program into other languages

5.1 Default files

During startup the program searches in the current folder for files used by default for the various functions. A list of these files is shown below.

PhotoCDBrowser.bmp	- splash file. This file is displayed on the opening screen until the user chooses a photo for viewing.

PhotoCDBrowser.ni	- bmp file.with extension ni (Navigator Icons). If the program finds such a file, the icons used for the navigator window are replaced by the icons from within this file.

The minimum variation (4 icons):

The maximum variation (13 icons):

The obligatory requirements for this file are:

•	height should be equal to 16 pixels

•	width in pixels has to be one of the following sets: 64 (4 icons), 80, 96, 112, 128, 144, 160, 176, 192, 208 (13 icons).

•	transparent color is RGB value (255, 0, 255)

PhotoCDBrowser.wav	- the sound file which is played during the startup of the program.

PhotoCDBrowser.ini	- the file containing the parameters and values for the program settings.

5.2 PhotoCDBrowser.ini setup

The appearance and behavior of the program is determined in many respects by the parameters and values within the PhotoCDBrowser.ini file. The parameters are read from this file only once - during the startup of the program. An example of the contents of this file along with popup explanations is shown below.

[General Settings]

ApplicationLanguage=English

ApplicationName=Photoarchive

ApplicationIcon=1

PathHorizon=

PathToStart=

BackgroundColor=0,0,0

PlaySoundCommentToPhoto=1

KeysHelpRunCount=0

IntelliMouseMode=z

ScaleStart=a

ScaleSavingMode=0

OpenWith=

[Navigator Settings]

Navigator=1

NavigatorRect=750,750,250,250

NavigatorDockingSpace=9

NavigatorBackgroundColor=255,255,255

NavigatorTextColor=0,0,0

[Comment Settings]

Comment=1

CommentRect=250,900,500,100

CommentRectAutoSize=1

CommentColor=255,255,255

CommentShadowColor=0,0,0

CommentShadowOffset=1

CommentFont=MS Sans Serif,8,0,0,0

CommentFontFile=

CommentsOrder=1

[Slideshow Settings]

SlideShowAutoExec=0

SlideShowAutoExecScript=

SlideShowDelay=5

SlideShowAbsolutePathes=0

SlideShowStopScreenSaver=1

SlideShowMoveDownCursor=0

SlideShowSmallEndAction=b

SlideShowTotalEndAction=b

[Thumbnails Settings]

Thumbnails=0

ThumbnailsSize=64

ThumbnailsSpaceX=13

ThumbnailsSpaceY=43

ThumbnailsBorderColor=0,0,255

ThumbnailsBorder=1

ThumbnailsCacheInFolders=0

[Music Settings]

Music=1

MusicPresent=a

MusicSearchMask=.\*.mp3

MusicRandom=0

The program automatically saves the settings in the PhotoCDBrowser.ini file when it closes including any changes made by the user during the program operation. Consequently you cannot set this file’s attribute to ReadOnly.

5.3 Setting files redefinition

Program understand local settings files. You can setup individual settings for the folder, slideshow script or graphic file. This local settings files may containes not all parameters but only needed for wanted distinction of folder, script, file. If the local file will contains not all parameters, then absent parameters will be inherited from global settings file or from previous local settings files. There are keyboard commands for local settings files managment:

Ctrl + D	- run Notepad to edit settings file attached to the current photo

Ctrl + Backspace - delete settings file attached to the current photo

Shift + D	- run Notepad to edit settings file in the current folder

Shift + Backspace - delete settings file in the current folder

If you have à script with SlideShow1.script.txt name then file with SlideShow1.script.ini name will be an attached to this script local settings file.

5.4 Multilanguage support

The language interface of the program is completely determined by the contents of a file *.lang.txt. The number of files with such an extension which reside in the same directory as the program will determine how many languages the program interface will support. The current language is determined by the value of the parameter ApplicationLanguage If, for example, the value of this parameter is set to AAA, the program will search for the file AAA.lang.txt and in a dialog box the user will be given a choice of languages with the default language shown as AAA. If the program does not find a file AAA.lang.txt, it will create it and fill it with the default English strings.

* * *


6.Version
1. Features	3. Slideshow	5. Interface setup
2. All commands	4. CD Creation	6. About version
The current program version is 2.80. A versions history is available here. New versions of the program will be upload to photocdbrowser.narod.ru. Send bug reports to photocdbrowser@narod.ru

PhotoCDBrowser is a freeware program with "AS IS" license agreement.

When creating this program the libraries of other authors were used:

PaintLib - Copyright © 1996-2000, Ulrich von Zadow

LibTiff - Copyright © 1988-1997 Sam Leffler, Copyright © 1991-1997 Silicon Graphics, Inc.

LibJpeg - Copyright © 1991-1997, Thomas G. Lane

Xaudio - Copyright © 1996-2000 Xaudio Corporation

I want give a token of appreciation to Bill Mudd for his input and collaboration in this file creation.

PhotoCDBrowser Copyright © 1999-2002 M.Onyshchuk

* * *


Term.CameraVendors
In the current version of this program the date and time stamp of a snapshot can be read from the digital cameras of the following vendors:

Agfa, Canon, Casio, Epson, Fujifilm, Hewlett-Packard, JVC, Kodak, Konica, Kyocera, Leica, Minolta, Nikon, Olympus, Ricoh, Toshiba, Sony, Yashica


Comment is text which can be displayed with a photo. The number of characters in each comment should not exceed 1023. Within the comment text you can use some macros or tags. Comments may be saved:

•	in graphic files with suitable formats (TIFF, JPEG)

•	in standard text files. In this case the file with the comment should have the extension "txt" and named with the same name as the photo it is commenting. In the navigator window such files have these icons:

It is available so:

•	comment to folder. To create such comment you need only create file with PhotoCDBrowser.txt name in the folder.

•	comment to slideshow script. For example, you have à script  with SlideShow1.script.txt name. Text file with  SlideShow1.comment.txt name will be a comment to such script.

•	global comment - file with comment.txt name near PhotoCDBrowser.exe.

Building order of result comments from embedded comments, comments to folder, scripts and global comments is determining by CommentsOrder parameter from setting file.


Navigator is a window that displays the folders and files you can choose to view in the program main window.

If you click the right mouse button within the navigator window a popup menu is displayed which enables the you to change to any directory above the current level directory.

For example in the navigator window if the folder is open to: C:\My Documents\My Photos\Archive\Part1, then the popup menu will look like:


Slideshow is a special program mode which displays one photo after another. The delay time between photo displays is determined by the parameter SlideShowDelay in the PhotoCDBrowser.ini file.


Sound comment to a photo is a sound format file (wav,MP3, etc.) located in the same folder as the photo itself. It must have the same name as the photo file (except it will have a sound format extension). The sound comment plays every time its associated photo file is displayed. In the navigator window files with sound comments have the following icon:


ApplicationLanguage

The language in which the menu and dialogs of the program will be displayed. This is determined by the value of the parameter ApplicationLanguage= in the PhotoCDBrowser.ini file. The value must be the same as the name of one of the language files with the extension .lang.txt.

If, for example, the parameter and value is:

ApplicationLanguage=English

The program will search for a file named English.lang.txt and display a dialog box of languages with the default choice shown as English.

If the parameter is empty, the program at startup will show a dialog box of all the language choices.


ApplicationName

The name which will be displayed on the title bar of the navigator window.


ApplicationIcon

Icon number (1-5), which will be assigned to the program during start.

Variants:


PathHorizon

This parameter limits the PhotoCDBrowser from displaying any files above the path assigned to this parameter. The current directory folder is not displayed in the Navigator window so the user can not access files above this directory. This is especially useful for CDs. If you place the graphic files you want displayed in the directory assigned to this parameter (or its subdirectories), the user will only have access the graphic files in those directories.

Examples:

:\Archive - path on a drive where the PhotoCDBrowser.exe file is located.

..\Main - path of a directory one level above the directory where PhotoCDBrowser.exe is located.

.\Photos - path of a directory one level below the directory where PhotoCDBrowser.exe is located.


PathToStart

The path (drive and directory) where you want the PhotoCDBrowser to begin displaying graphic files. It can be a different drive and directory than where the PhotoCDBrowser.exe program is located. When the Navigator window is activated, it will display all the files in this directory including the directory and any subdirectory folders. The current directory folder is displayed as open. If the user clicks on the open directory folder, the Navigator will then display all the files and folders in the path above the one listed in this parameter. This  way the Navigator window can be used to explore the rest of the computer for other graphic files to display in PhotoCDBrowser. To limit this feature see PathHorizon.

Examples:

:\Archive - path on a drive where the PhotoCDBrowser.exe file is located.

..\Main - path of a directory one level above the directory where PhotoCDBrowser.exe is located.

.\Photos - path of a directory one level below the directory where PhotoCDBrowser.exe is located.


Navigator

To show or to not show the navigator window at the startup of the program

Variants:

0 - navigator window is hidden at startup

1 - navigator window is visible at startup


NavigatorRect

Initial coordinates of navigator window. It's assumed that the size of the program window is 1000x1000 and the real screen resolution is substituted later. The order of the field coordinates are as follows - X, Y, W, H (horizontal displacement from the left side of the screen, vertical displacement from the top of the screen, width, height).


BackgroundColor

Color of the background of the main program display window. It is set using RGB values.


Comment

To show or to not show the comment to photos at once startup of the program.

Variants:

0 - comment is hidden

1 - comment is visible


CommentRect

Coordinates of the display rectangle for comments. It's assumed that the size of the program window is 1000x1000 and the real screen resolution is substituted later. The order of the field coordinates are as follows - X, Y, W, H (horizontal displacement from the left side of the screen, vertical displacement from the top of the screen, width, height).


CommentRectAutoSize

Parameter for switching on the autosize mode in displaying comment text. If the comments with the current font do not fit within the display rectangle specified by the parameter CommentRect, the display rectangle will be re-sized to fit the comment.

Possible values:

0 - comment rect autotuning is turned off

1 - comment rect autotuning is turned on

Default value - 1.


CommentColor

Comment text color. It is set using RGB values.


CommentShadowColor

Color of comment text shadow. It is set as an RGB value.


CommentShadowOffset

Value of the displacement to the right and downwards from the comment text (in pixels).


CommentFont

Font of the comment. The order of font name and effect fields are as follows:

the name, size, Bold (0-1), Italic (0-1), Underline (0-1).

Font by default - Arial,24,0,0,0


CommentFontFile

Name of a font file which should be in the same folder as the program. This parameter has to be specified when you want to use fonts which might not be loaded or even exist on the computer viewing the CD with the PhotoCDBrowser program. You should also include the font file itself just to be safe.


SlideShowAutoExec

The value which specifies whether or not Total Slideshow will start immediately after the startup of the program.

Variants:

0 - to not start

1 - to start


SlideShowAutoExecScript

The designated script of a slideshow will begin at the startup of the program if the parameter SlideShowAutoExec is set to the value 1.

Example of the parameter designating a slideshow script:

SlideShowAutoExecScript=Slideshow1.script.txt


SlideShowDelay

Delay between two successive frames in slideshow mode. It is measured in seconds.

Variants:

minimum value - 1,

maximum value - 600,

default value - 5.


SlideShowAbsolutePathes

Parameter which specifies what type of path (absolute or relative) is assigned to the photo files and written to the

slideshow script during the current total slideshow if Ctrl + S is pressed.

Variants:

1 - absolute pathes, i.e. with actual drive letter (for example "e:\my archive").

0 - not absolute pathes, i.e. without a drive letter but with a path "relative" to the drive root (for example ":\my archive").

Default value - 0


PlaySoundCommentToPhoto

Value that determines if sound comments are played. It can also be changed from the menu or the keyboard (F4).

Variants:

0 - the comment will not play

1 - the comment will play


KeysHelpRunCount

Number of times the program starts with hot keys hints displayed. Each start of the program decrease this value by 1 (it is true only for hard drives, not for CD).

Default value - 0


IntelliMouseMode

IntelliMouse operation mode.

Variants:

z - zooming

n - navigation on files (next-previous)


ScaleSavingMode

Value that determines if the scale of the previous image will be saved and applied to the next image after a transition. This parameter can be changed by the Alt+S shortkey.

Variants:

0 - scale is not saved

1 - scale is saved


OpenWith

The name of the program which is used to open the current file when Ctrl+O is pressed. If  this value is not specified - the program used is the one associated in MS Windows with files that have this type of extension such as (*.tif, *.jpg, ...).

Examples:

photoshp.exe

acdsee.exe

It is possible to specify any program listed in the Windows registry under:

HKEY_CLASSES_ROOT\Applications


Music

Parameter which specifies whether background music is included. It can also be changed through the menu or keyboard (F3).

Variants:

0 - background music is switched off

1 - background music will play or at once after start of the program, or after start of a slideshow. It is sets by MusicPresent parameter.


MusicPresent

Parameter specifies if background music always plays in the background or only during slideshows.

Variants:

a - background music will play always.

s - in slideshow only


MusicSearchMask

Parameter sets a mask for searching a set of music files used as background music or as sound comments. It searches all files with MP1, MP2 and MP3 formats.

Examples of parameter writing:

MusicSearchMask=C:\My Music\*.* - all files in the folder C:\My Music will be searched.

MusicSearchMask =:\Autorun\*.mp? - in this case it is supposed, that PhotoCDBrowser will be started from drive, in which root the folder Autorun is located. In this folder all files, in which extantion the first 2 letters are MP, and third is anyone will be searched.

MusicSearchMask =*.mp3 - all files with extension mp3 located in the same folder with PhotoCDBrowser will be searched. No search is made of subfolders. Files are sorted by name.


MusicRandom

Parameter sets in what order the background music files are played. The files can be played as sorted by name or randomly.

Variants:

0 - the music files will be played as sorted by name.

1 - the music files will be played randomly.


Term.RGB
RGB is a designation of color in combinations of red, green and dark blue in that order (Red, Green, Blue). The amount of each of these colors in a combination is set by numbers from 0 to 255.

Examples:

0,0,0 - black

255,255,255 - white

255,0,0 - red

0,255,0 - green

0,0,255 - blue


Term.SlideShowScript
Slideshow script is a text file with the extension  .script.txt

An example of the name of a slideshow script file - Summer 2000.script.txt

If such a file were placed in the same folder with PhotoCDBrowser, then at the start of a Total Slideshow a menu would appear with choices that would include the script Summer 2000.

The slideshow script file has a very simple structure. On the first line is written a format value (and a semicolon after which any comments can be written). All subsequent lines beginning with the second line are composed of the path and name of each of the image files – each image file and its path must have a separate line.

Variants of pathes designations:

 C:\My Documents\My Phots\Photo1.jpg

:\My Archive\Photo1.jpg

In the second example above it is assumed that the folder "My Archive" is located on the same drive as the PhotoCDBrowser program. For a CD it is necessary to use this second variation of designating a path.


SlideShowStopScreenSaver

Parameter, which specifies to stop or not to stop screensaver during slideshow running.

Variants:

0 - to not stop

1 - to stop

Default value - 1


SlideShowTotalEndAction

Parameter specifies action which will be performed at the end of Total Slideshow.

Variants:

b - to begin a slideshow again

s - to stop a slideshow

q - to quit program

Default value - b


ScaleStart

Start scale mode.

Variants:

r - (Real) - each photo will initially be displayed in real scale (see "Real Scale" menu item).

f - (Fit to Screen) - each photo will initially be fitted to screen.

a - (Auto) - "automatic" mode. This means that in the case of small photo (if the size of photo is less than size of the screen area) it will be displayed in real scale and in case of a large photo it will be fitted to screen.


NavigatorBackgroundColor

If this parameter is present and given a value, the color (RGB) of the navigator window’s background will have that color value. Otherwise the color from the default Windows setting will be used.

Parameter is not obligatory!


NavigatorTextColor

If this parameter is present and given a value, the color (RGB) of navigator text labels will have that color value. Otherwise the color from the default Windows setting will be used.

Parameter is not obligatory!


Thumbnails

Parameter which turns on or turns off thumbnails mode. In this mode small reduced copies of each photo are displayed within the navigator window instead of text names being displayed. This parameter can also be turned on or turned off using the menu or keyboard (Ins).

Variants:

0 - Thumbnails mode is turn on

1 - Thumbnails mode is turn off


ThumbnailsSize

Size of thumbnails - equals the size of thumbnails set in pixels.

Variants:

minimal value - 32

maximal value - 96


ThumbnailsSpaceX

Horizontal spacing between two thumbnails. It set in pixels.

Variants:

minimal value - 13

maximal value - 53


ThumbnailsSpaceY

Vertical spacing between two thumbnails. It sets in pixels.

Variants:

minimal value - 13

maximal value - 53


ThumbnailsBorderColor

Thumbnail border color. It is set as an RGB value.


ThumbnailsBorder

Parameter which determines whether the thumbnails have a border.

Variants:

0 - frame is drawing

1 - frame is absent


ThumbnailsCacheInFolders

Parameter which turns on thumbnails being cached in a folder, i.e. it allows the creation of the photocdbrowser.cache file containing all the thumbnails for the current folder.

Variants:

0 - caching turn off - photocdbrowser.cache files will not be created

1 - caching turn on - photocdbrowser.cache files will be created


NavigatorDockingSpace

Parameter which designates docking space near screen boundaries. It is measured in pixels.

Variants:

minimum value - 0 (navigator docking is turned off),

maximum value - 19,

default value - 9.


CommentsOrder

This parameter determine a result comment building order.

Variants:

1 - a result comment text will be given by means fusion of all existings parts in order from embedded to global comments. In general case so:

•	embedded comment into the graphic file (only for TIFF or JPEG formats)

•	attached to the graphic file a comment text file

•	comments, attached to the folders or slideshow scripts

•	global comment

2 - same as previous variant, but in the reverse order - from the global to the embedded comments.

3 - program use as a result comment only one (first) comment, which will be exist if program will be search from embedded comment to global comment.

4 - program use as a result comment only one (first) comment, which will be exist if program will be search from global  comment to embedded comment.


SlideShowSmallEndAction

Parameter specifies action which will be performed at the end of Small Slideshow.

Variants:

b - to begin a slideshow again

s - to stop a slideshow

q - to quit program

Default value - b


SlideShowMoveDownCursor

Parameter, which specifies to move down (to hide) or not to move down mouse cursor during slideshow running.

Variants:

0 - to not move down

1 - to move down

Default value - 0